<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML lang="en">
<HEAD>
 <LINK rel="StyleSheet" href="../BBWin.css">
 <TITLE>Procs</TITLE>
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
 <meta name="copyright" content="Copyright &copy; 2006 by Etienne Grignon. Licenced under GPL.">
</HEAD>
<BODY>
 <H1>Procs</H1>
 <H3>Description</H3>
<p>
Procs agent is used to monitor processus. 
</p>
<H3>Configuration</H3>
<UL>
 <LI class="OptionDirective"><b>setting</b> directive syntax :
<p>
<pre class="Config">
&lt;setting name="" value="" /&gt;
</pre>
<LI class="OptionDirective">generic settings
<p>
<table class="OptionTable" cellSpacing="0" cellPadding="0" border="1" id="table1">
	<tr>
		<td class="OptionTitle" vAlign="top" >
		name
		</td>
		<td class="OptionTitle">
		value
		</td>
	</tr>
	<tr>
		<td class="OptionValue" vAlign="top" >
		testname
		</td>
		<td class="OptionValue" vAlign="top">
		You can set the testname that will be sent to the monitoring server (column name in
		the bbdisplay)
		<b>Default is "procs"</b></td>
	</tr>
</table>
 <LI class="OptionDirective"><b>rules</b> directive syntax :
<p>
<pre class="Config">
&lt;setting name="" rule="" alarmcolor="" comment=""/&gt;
</pre>
<p>
If the name value is not one of the generic settings, then, procs will understand that it is a procs custom rule.
To create a custom procs rule, you may use the process name in the name attribute.
</p>
<p>
<table class="OptionTable" cellSpacing="0" cellPadding="0" border="1" id="table2">
	<tr>
		<td class="OptionTitle" vAlign="top" >
		alarmcolor
		</td>
		<td class="OptionValue" vAlign="top">
		You can set the alarm color you want to use if their is an alert.
		It should be set to red or yellow.
		<b>Default is yellow</b>.
		</td>
	</tr>
	<tr>
		<td class="OptionTitle" vAlign="top" >
		comment
		</td>
		<td class="OptionValue" vAlign="top">
		A simple string which appear in the report to add a small information about the processus monitored if 
		its name is not easy to understand.
		This parameter is optionnal</td>
	</tr>
	<tr>
		<td class="OptionTitle" vAlign="top" >
		name
		</td>
		<td class="OptionValue" vAlign="top">
		name attribute should be the name of the process you want to monitor.
		This parameter is <b>required</b></td>
	</tr>
	<tr>
		<td class="OptionTitle" vAlign="top" >
		rule
		</td>
		<td class="OptionValue" vAlign="top">
		Rule is composed of a numeric sign followed by a numeric value.
		Possibles signs are '-=', '+=', '-', '+' or	'='.
		'-' means &lt; and '+' means &gt;.
		See the example below.
		This parameter is <b>required</b></td>
	</tr>
</table>
</UL>
<H3>Examples</H3>
<UL>
 <LI>procs is configured to check that no drwtsn process are running ; it will warn red if one is present in memory.
 Also, it check that one instance of pageant.exe is always running ; it will warn yellow if its count is different
 than 1
<p>
<pre class="Config">
&lt;procs&gt;
	&lt;setting name="drwtsn" rule="-1" alarmcolor="red" /&gt;
	&lt;setting name="pageant.exe" rule="=1" comment="Putty agent deamon" /&gt;
&lt;/procs&gt;
</pre>
</UL>
<H3>Notes</H3>
<UL>
 <LI>proc name in the procs rules can be part of it and is case insensitive.
</UL>
</BODY>
</HTML>
